PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Window Manager >

Programming With the Mac OS 8.5 Window Manager

InvalWindowRgn

Adds a region to a window's update region.

pascal OSStatus InvalWindowRgn (
                     WindowPtr window,
                     RgnHandle region);
window
A value of type WindowPtr . Pass a pointer to the window containing the region that you wish to be updated.
region
A value of type RgnHandle . Before calling InvalWindowRgn , set this region to specify, in local coordinates, the area to be added to the window's update region.
function result
A result code. See Result Codes.
DISCUSSION

The InvalWindowRgn function informs the Window Manager that an area of a window should be redrawn. The InvalWindowRgn function is similar to the InvalRgn function, but InvalWindowRgn allows the window that it operates upon to be explicitly specified, instead of operating on the current graphics port, so InvalWindowRgn does not require the graphics port to be set before its use. See Maintaining the Update Region for further discussion.

VERSION NOTES

Available with Mac OS 8.5 and later.

SEE ALSO

The function InvalWindowRect .

The function ValidWindowRgn .

© 1999 Apple Computer, Inc. – (Last Updated 18 March 99)